<!--
To change this template, choose Tools | Templates
and open the template in the editor.
-->
<!DOCTYPE html>
<html>
    <head>
        <title>Gui Explained</title>
        <link rel="stylesheet" href="nbdocs:/org/netbeans/modules/usersguide/ide.css" type="text/css">
        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    </head>
    <body>
        <h1>Panels</h1>        
        <h2>Tree List</h2>
        <p>
            This panel contains the list of tree definitions. To open a tree definition
            just double click on the name. You will see that the title of the window will
            change. Use the title to see wich tree is opened (you can not rely on the 
            selection in the list).
        </p>
        <p>
            The tree defintion is based on an arbaro file and on textures. The arbaro file
            is used to make the mesh (uses arbara project). More info on arbaro can be 
            found at http://sourceforge.net/projects/arbaro/. The texture tiles are part
            of the definition, together with the #horizontal, #vertical and #top values.
            The random seeds are not part of the definition. The random seeds are used 
            to create a certain instance.
        </p>                
        <p>            
            You can save, rename or remove the loaded tree by clicking on the buttons on the
            bottom of this panel. There is also a button to create a new tree defintion. This
            will ask for the name of the definition and an arbaro file (this file will be copied
            to a new directory)
        </p>        
        <p>
            The definitions can be found in your assets under assets/Trees/Definitions. This folder
            (and some examples) will be created when you first use the plugin. 
        </p>
        <h2>Arbaro Parameters</h2>
        <p>
            Here you can see and change the arbaro parameters. More info on the parameters can be found
            at http://sourceforge.net/projects/arbaro/ and in the paper named: "Jason Weber & Joseph 
            Penn: "Creation and Rendering of Realistic Trees".
            Changes of a parameter will only be registered after pressing enter. When leaving the textbox
            before pressing enter, the previous value will reappear. Do not forget to save the changes
            by clicking save in the "Tree List" panel.            
        </p>       
        <h2>Texture parameters</h2>
        <p>
            The textures are based on tiles. These tiles must be tileable (no seam when putting them next
            to each other). You can also choose to create a custom texture for a tree by adding only one tile.
            You will then have to deform your texture because tiles must be square. When adding multiple tiles
            the tiles al must have the same size(pixels).
        </p>
        <p>
            The trunk and stem textures are based on tiles. These tiles are combined by a random generator to create
            the texture used by the mesh. The number of tiles used are given by the #horizontal(number of horizontal
            tiles) and #vertical(the number of vertical tiles). The uv-map of the stem and trunk is comparable with
            a simple drawing of a house, with a triangle at the top. In this top the texture must be horizontal
            mirrored. The value #top (number of top tiles) describes how many rows of tiles are mirrored.
            The seed value is used to initialize the random generator.
        </p>
        <p>
            Leaf textures combine the tiles to an nxn matrix where n is smallest value where n*n < number of tiles.
            The tiles are then randomly linked to the leaves. If you want a tile to be more present, you must add
            this tile multiple times.
        </p>
        <p>
            Do not forget to save you changes by clicking save in the Tree List panel.
        </p>
        <p>
            This panel will change in later updates: you will be able to choose different textures for each
            stem level. (Necessary for palms)
        </p>
        <h2>Tree</h2>
        <p>
            In this panel you can choose the random seed of the tree shape. This seed only has an effect on the
            shape of the tree, not on the textures.
            By clicking "Create tree" the tree is created and displayed in the preview window. If you like this tree
            you can create a .j3o file by creating "Export tree". This tree can be found in 
            assets/models/Trees/'tree name'/'seeds'.j3o . The textures used by this model can be found in
            assets/Textures/Trees/'tree name'/'leaf,trunk or stem'/'seed'.png . This texture may be used by multiple
            trees.
        </p>
        <p>
            On the bottom of this panel you will see a status label. In this label you will get information about the
            creation of the tree and the name of the exported tree.
        </p>
    </body>
</html>
